home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr22 / fixtim20.zip / README < prev    next >
Text File  |  1993-04-15  |  10KB  |  247 lines
  1.  
  2.                         FIXTIME Version 2.0
  3.      
  4.      (C) COPYRIGHT 1986, 1992, 1993 by Michael Coulter.  All rights reserved.
  5.      Shareware fee: $10
  6.  
  7. Fixtime is a utility which you can run to adjust your computer's clock
  8. for the expected error since the last time the clock was adjusted.
  9.  
  10. This README file has the following sections:
  11.  
  12. 1. Quick Installation and Use Instructions
  13. 2. Installation Variations 
  14. 3. How Fixtime Works
  15. 4. Documentation of Commands
  16.    4.1 Fixtime
  17.    4.2 Showtime
  18.    4.3 Today
  19. 5. Files in this Distribution
  20. 6. Registration and Disclaimer
  21.  
  22.  
  23. 1. Quick Installation and Use Instructions
  24.  
  25.    These instructions presume that your boot disk is "c:".
  26.  
  27.    First, set the clock on your computer as accurately as possible.  
  28.  
  29.    Extract the fixtime files and copy them to "c:\".
  30.  
  31.    Create the fixtime.inf data file by executing:
  32.    
  33.        cd c:\
  34.        fixtime -i
  35.  
  36.    Edit your c:\autoexec.bat file and add the following line early in the
  37.    file:
  38.    
  39.        fixtime -f c:\fixtime.inf
  40.  
  41.    Wait a few days until you notice that your computer's clock has become 
  42.    inaccurate.  You might execute "showtime" to display the time and beep 
  43.    as each second changes.  If your computer has gained 7 seconds, move 
  44.    the clock back by executing:
  45.  
  46.           cd c:\
  47.        fixtime -7
  48.  
  49.    If your computer has lost 7 seconds, move the clock forwards by 
  50.    executing:
  51.  
  52.           cd c:\
  53.        fixtime 7
  54.  
  55.    Now, the next time fixtime is executed it will adjust the computer's
  56.    clock according to the clock drift which has been observed on this
  57.    computer.  When you notice that the computer's clock is inaccurate,
  58.    adjust it with fixtime and a more accurate adjustment factor will
  59.    automatically be computed.  Always execute "cd c:\" before executing
  60.    fixtime so that the fixtime.inf file will be in the current directory.
  61.  
  62.    In the spring, when daylight savings time is instituted, move your
  63.    clock forward by executing:
  64.  
  65.           cd c:\
  66.        fixtime +h
  67.  
  68.    In the fall, when standard time is instituted, move your clock back
  69.    by executing:
  70.  
  71.           cd c:\
  72.        fixtime -h
  73.  
  74.    Send in your $10 registration fee (see instructions below).
  75.  
  76. 2. Installation Variations 
  77.  
  78.    The fixtime files don't need to be located at "c:\".  The executable
  79.    files may be placed in any directory which appears in your PATH string.
  80.    The README file can be placed wherever you like to keep documentation.
  81.  
  82.    The fixtime.inf file can be placed anywhere.  It is easiest to use
  83.    fixtime by making the directory which contains fixtime.inf the current
  84.    directory before executing fixtime.exe.  You can be in a different
  85.    directory and use the -f option to specify the location of the
  86.    fixtime.inf file.  For example, if you install the fixtime.inf file
  87.    in c:\misc\fixtime.inf, the line in your autoexec.bat file would be:
  88.  
  89.           fixtime -f c:\misc\fixtime.inf
  90.    
  91. 3. How Fixtime Works
  92.  
  93.    IBM PC AT's and later have a real-time clock which is used to set the
  94.    DOS time when the system is booted.  Thereafter the two times are
  95.    independent.  The DOS clock is frequently much less accurate than
  96.    the real-time clock.  The DOS clock might lose 5 minutes a day while the
  97.    real-time clock might lose 4 minutes a month.
  98.  
  99.    Typically the real-time clock in a computer loses or gains a consistent
  100.    amount of time.  FIXTIME is a utility which compensates for this "clock
  101.    drift" by periodically adjusting the clock based on the past history
  102.    of clock drift on a particular computer.  Typically FIXTIME is executed
  103.    when the computer is started by running it in the \AUTOEXEC.BAT file.
  104.  
  105.    The information file which FIXTIME maintains is in an ASCII file, 
  106.    fixtime.inf, which has five lines.  They are:
  107.     
  108.        1) The adjustment factor.
  109.        2) Any fractional seconds not adjusted at the time of the last
  110.       adjustment.
  111.        3) The total of all adjustments since the start of operation.
  112.        4) The date and time when the clock was last adjusted.
  113.        5) The date and time when fixtime first started operation.
  114.  
  115.    Note that FIXTIME only adjusts the clock by a whole number of seconds.
  116.    It rounds to the nearest second and keeps track of the fractional
  117.    second difference in line #2.
  118.  
  119.    When fixtime -r is executed, the times in lines #4 and #5 are set to
  120.    now and the numbers in lines #2 and #3 are set to zero, but the adjustment
  121.    factor in line #1 is left unchanged.
  122.  
  123. 4. Documentation of Commands
  124.    
  125.    4.1 Fixtime
  126.        
  127.        The FIXTIME utility may be used to perform one of five functions:
  128.  
  129.     4.1.1 Install (-i) the information file where FIXTIME records the 
  130.           clock drift factor for this computer and where it records the 
  131.           last time the clock was adjusted.  By default, the file name
  132.           will be FIXTIME.INF in the current directory.  
  133.  
  134.           Syntax:     fixtime [ -f inf_file ] [ -i ]
  135.           Examples:    fixtime -i
  136.                     fixtime -f c:\misc\fixtime.inf -i
  137.        
  138.           Before creating the information file, you should set the
  139.           time on your computer as accurately as possible.  FIXTIME will
  140.           start measuring the clock drift on your system from the time
  141.           you create the file.
  142.     
  143.     4.1.2 Adjust the computer's real-time clock by a specified number of 
  144.           seconds (positive or negative).
  145.  
  146.           Syntax:      fixtime [ -f inf_file ] seconds 
  147.           Examples:    fixtime 3
  148.                    fixtime -2 
  149.                    fixtime -f fixtime.inf 25
  150.  
  151.           The first example moves the clock forward by three seconds. The
  152.           second example moves the clock back by two seconds.  The third
  153.           example moves the clock forward by 25 seconds. As the clock on
  154.           your computer loses or gains time, add or subtract seconds to the
  155.           clock to correct it.  FIXTIME keeps a total of the seconds which
  156.           have been added or subtracted from the clock.  It uses this total
  157.           together with the time when the total started out at zero to
  158.           calculate the adjustment factor to compensate for the clock
  159.           drift.
  160.        
  161.           After adjusting the real-time clock, FIXTIME sets the DOS clock 
  162.           to the same time.
  163.     
  164.     4.1.3 Adjust the clock for clock drift since the last time the clock
  165.           was adjusted.
  166.     
  167.           Syntax:    fixtime [ -f inf_file ]
  168.           Examples:    fixtime
  169.                     fixtime -f c:\misc\fixtime.inf
  170.  
  171.           This command is typically invoked in \AUTOEXEC.BAT to adjust the
  172.           clock when the system is booted.  If FIXTIME.EXE is in a directory
  173.           in your PATH string and the information file is c:\fixtime.inf,
  174.           here is the line you would put in your c:\autoexec.bat file:
  175.        
  176.                     fixtime -f c:\fixtime.inf
  177.  
  178.     4.1.4 Move the clock forwards (+h) or backwards (-h) by one full hour,
  179.           but don't count this in the number of seconds by which the clock
  180.           has been adjusted.  This is typically used when daylight savings
  181.           time changes.
  182.  
  183.           Syntax:    fixtime [ -f inf_file ] +h
  184.               or:    fixtime [ -f inf_file ] -h
  185.           Examples:    fixtime -h
  186.                     fixtime -f c:\misc\fixtime.inf +h
  187.      
  188.     4.1.5 Reset (-r) the installation time of FIXTIME to the
  189.           current time and reset the total number of seconds to
  190.           zero, but keep the current adjustment factor.  This
  191.           establishes a new base from which to measure your
  192.           computer's clock drift. This function is typically used
  193.           when you have manually set your clock after some program
  194.           has improperly set it or when you replace the clock's
  195.           battery.
  196.  
  197.            Syntax:    fixtime [ -f inf_file ] -r
  198.            Examples:    fixtime -r
  199.                     fixtime -f c:\misc\fixtime.inf -r
  200.  
  201.    4.2 Showtime
  202.  
  203.        SHOWTIME.EXE displays the real-time clock date and time and beeps
  204.        every time the second changes.  It doesn't take any arguments. It
  205.        is useful to run so that you can look at your watch and see how
  206.        far off the computer is when it beeps.
  207.  
  208.    4.3 Today
  209.  
  210.        TODAY.EXE sets the DOS time from the real-time clock time and
  211.        then displays the date and time.  It doesn't take any arguments.
  212.  
  213. 5. Files in this Distribution
  214.  
  215.     FIXTIME  EXE     16720 04-15-93   9:31p
  216.     README            9594 04-15-93   9:31p
  217.     SHOWTIME EXE     12240 04-15-93   9:31p
  218.     TODAY    EXE     12640 04-15-93   9:31p
  219.             
  220. 6. Registration and Disclaimer
  221.  
  222.    These programs are provided as-is.  Michael Coulter makes no express or 
  223.    implied warranty of any kind with respect to these programs.  Michael Coulter
  224.    shall not be liable for any direct indirect, special, incidental or 
  225.    consequential damages (whether based on contract, tort or any other 
  226.    legal theory) arising in any way from use of these programs.
  227.  
  228.    Everyone is granted permission to copy and redistribute the set of files
  229.    described above provided:
  230.        
  231.        1. No changes are made to any of the files in the distribution and
  232.           all of the files are provided in any copy.
  233.        
  234.        2. No charge is made for this software.  This clause shall not 
  235.           be construed as constraining other software distributed on 
  236.           the same medium as this software, nor is a distribution fee 
  237.           considered a charge.
  238.  
  239.    This software may be used without charge for a 30-day trial period
  240.    or any time after January 1, 1999.   If you want to use the software
  241.    beyond the trial period and before 1999, send a license fee of $10 U.S. to:
  242.  
  243.            Michael Coulter
  244.            73 La Vonne Dr.
  245.            Campbell, CA  95008
  246.            U.S.A.
  247.